-- *****************************************************************
-- CISCO-MAC-NOTIFICATION-MIB.my: Cisco MAC Notification MIB
--
-- October 2001, Edward Pham
-- February 2003, Padma Pullela
--
-- Copyright (c) 2001, 2003, 2006 by cisco Systems, Inc.
-- All rights reserved.
--
-- *****************************************************************CISCO-MAC-NOTIFICATION-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,OBJECT-TYPE,Counter32,NOTIFICATION-TYPE,Unsigned32,Integer32FROM SNMPv2-SMI
MODULE-COMPLIANCE,OBJECT-GROUP,NOTIFICATION-GROUPFROM SNMPv2-CONF
TruthValue,TimeStamp,MacAddress,TEXTUAL-CONVENTION
FROM SNMPv2-TC
ifIndex
FROM IF-MIB
VlanIndexFROM CISCO-VTP-MIB
entPhysicalIndex
FROM ENTITY-MIB
Percent
FROM CISCO-QOS-PIB-MIB
ciscoMgmt
FROM CISCO-SMI;ciscoMacNotificationMIB MODULE-IDENTITYLAST-UPDATED"200706110000Z"ORGANIZATION"Cisco Systems, Inc."CONTACT-INFO" Cisco Systems
Customer Service
Postal: 170 W Tasman Drive
San Jose, CA 95134
USA
Tel: +1 800 553-NETS
E-mail: cs-wbu@cisco.com"DESCRIPTION"This MIB module is for configuration of the MAC notification
feature. MAC notification is a mechanism to inform monitoring
devices when there are MAC addresses learnt or removed from
the forwarding database of the monitored devices."REVISION"200706110000Z"DESCRIPTION"Fixed typo and made changes to the description of
cmnMACMoveObjects, cmnMACThresholdNotifEnabled and
cmnMacThresholdExceedNotif."REVISION"200303210000Z"DESCRIPTION"Added cmnMACMoveObjects, cmnMACThresholdObjects."REVISION"200110220000Z"DESCRIPTION"Initial version of this MIB module."::={ ciscoMgmt 215}-- Cisco MAC Notification MIB object definitionsciscoMacNotificationMIBObjects OBJECTIDENTIFIER::={ ciscoMacNotificationMIB 1}
-- Cisco MAC Notification MIB consists of the following groups
-- [1] Cisco Mac Notification Global Group (cmnGlobalObjects).
-- [2] Cisco Mac Notification Interface Group (cmnInterfaceObjects).
-- [3] Cisco Mac Notification Move Group (cmnMACMoveObjects).
-- [4] Cisco Mac Notification Threshold Group (cmnMACThresholdObjects).cmnGlobalObjects OBJECTIDENTIFIER::={ ciscoMacNotificationMIBObjects 1}cmnInterfaceObjects OBJECTIDENTIFIER::={ ciscoMacNotificationMIBObjects 2}cmnMACMoveObjects OBJECTIDENTIFIER::={ ciscoMacNotificationMIBObjects 3}cmnMACThresholdObjects OBJECTIDENTIFIER::={ ciscoMacNotificationMIBObjects 4}
--**********************************************************************
-- Cisco Mac Notification Global Group
--**********************************************************************cmnGlobalFeatureEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates whether the MAC notification feature is currently
running in the device.
Setting this object to false(2) disables the MAC notification
feature globally thus disabling the feature at each interface.
Setting this object to true(1) will start the MAC notification
feature running in the device. If the feature is already
running, setting to true(1) has no effect. Once the MAC
notification is enabled, whether the feature is running at each
interface is controlled by the cmnIfConfigTable."::={ cmnGlobalObjects 1}
cmnNotificationInterval OBJECT-TYPESYNTAXUnsigned32(0..4294967295)UNITS"seconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"This object specifies the maximum interval of time between
cmnMacChangedNotifications being generated by the device.
If the value of cmnNotificationsEnabled is true(1), the
device will send out the generated cmnMacChangedNotifications
and archive the MAC change notification events in the
cmnHistoryTable. If the value of cmnNotificationEnabled is
false(2), the device will not send out the generated
cmnMacChangedNotifications but it will archive these events
in the cmnHistoryTable.
If the value of this object is equal to 0, the device will
generate cmnMacChangedNotifications and archive the MAC
change notification events in the cmnHistoryTable as soon as
there is MAC address learnt or removed by the device.
If the value of this object is greater than 0, the device will
wait for a period of time equal to the value of this object
before generate the cmnMacChangedNotifications and archive
the MAC change notification events in the cmnHistoryTable."::={ cmnGlobalObjects 2}cmnMacAddressesLearnt OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the number of MAC addresses learnt by the
device."::={ cmnGlobalObjects 3}cmnMacAddressesRemoved OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the number of MAC addresses removed from the
forwarding database."::={ cmnGlobalObjects 4}cmnNotificationsEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates whether cmnMacChangedNotification notifications
will or will not be sent when there are MAC addresses
learnt or removed from the device's forwarding database.
Disabling notifications does not prevent the MAC address
info from being added to the cmnHistoryTable."DEFVAL{ false }::={ cmnGlobalObjects 5}
cmnNotificationsSent OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the number of cmnMacChangedNotifications sent out
by the device."::={ cmnGlobalObjects 6}cmnHistTableMaxLength OBJECT-TYPESYNTAXUnsigned32(0..500)UNITS"entries"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The upper limit on the number of entries that the
cmnHistoryTable may contain. A value of 0 will
prevent any history from being retained. When this
table is full, the oldest entry will be deleted and
a new one will be created."DEFVAL{1}::={ cmnGlobalObjects 7}cmnHistoryTable OBJECT-TYPESYNTAXSEQUENCEOF CmnHistoryEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table will archive the MAC change notification events
generated by this device. The MAC change notification
events are archived here even if cmnMacChangesNotifications
are not actually sent."::={ cmnGlobalObjects 8}cmnHistoryEntry OBJECT-TYPESYNTAX CmnHistoryEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A MAC change notification message that was previously
generated by this device. Each entry is indexed by a message
index."INDEX{ cmnHistIndex }::={ cmnHistoryTable 1}
CmnHistoryEntry ::=SEQUENCE{
cmnHistIndex
Unsigned32,
cmnHistMacChangedMsg
OCTETSTRING,
cmnHistTimestamp
TimeStamp}cmnHistIndex OBJECT-TYPESYNTAXUnsigned32(1..4294967295)MAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"An index that uniquely identifies a MAC change notification
event previously generated by the device. This index starts at
1 and increases by one when a MAC change notification is
generated. When it reaches the maximum value, the agent wraps
the value back to 1."::={ cmnHistoryEntry 1}cmnHistMacChangedMsg OBJECT-TYPESYNTAXOCTETSTRING(SIZE(1..254))MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"This object contains the information of a MAC change
notification event. It consists of several tuples packed
together in the format of '<tuple1><tuple2>...'.
Each tuple consist of 11 octets in the format of
'<operation><VLAN><MAC><dot1dBasePort>' where
<operation> is of size 1 octet and supports the following values
0 - End of MIB object.
1 - MAC learnt.
2 - MAC removed.
<VLAN> is VLAN number of the VLAN which the MAC address is
belonged to and has size of 2 octet.
<MAC> is the Layer2 Mac Address and has size of 6 octets.
<dot1dBasePort> is the value of dot1dBasePort for the
interface from which the MAC address is learnt and has size
of 2 octets."::={ cmnHistoryEntry 2}cmnHistTimestamp OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when the cmnMacChangedNotification
containing the information denoted by the cmnHistMacChangedMsg
object in this entry was generated."::={ cmnHistoryEntry 3}--*********************************************************************
-- Cisco Mac Notification Interface Group
--*********************************************************************--
-- cmnIfConfigTable
--cmnIfConfigTable OBJECT-TYPESYNTAXSEQUENCEOF CmnIfConfigEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"This table enables or disables the generation of notification
at each interface when MAC address is learnt or removed."::={ cmnInterfaceObjects 1}cmnIfConfigEntry OBJECT-TYPESYNTAX CmnIfConfigEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"Each entry contains the configuration for enabling the
MAC notification at each interface that supports this
feature."INDEX{ ifIndex }::={ cmnIfConfigTable 1}
CmnIfConfigEntry ::=SEQUENCE{
cmnMacAddrLearntEnable TruthValue,
cmnMacAddrRemovedEnable TruthValue}cmnMacAddrLearntEnable OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates whether this interface is enabled to send
cmnMacChangedNotification when it learns a new MAC address. This
variable has no effect when the value of cmnGlobalFeatureEnabled
object is false(2).
Setting this object to true(1) enables the sending of
cmnMacChangedNotification when this interface learns a
new MAC address.
Setting this object to false(2) disables the sending
of cmnMacChangedNotification when this interface learns
a new MAC address."DEFVAL{ false }::={ cmnIfConfigEntry 1}cmnMacAddrRemovedEnable OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicates whether this interface is enabled to send
cmnMacChangedNotification when a MAC address which it learnt
previously is removed from the forwarding table. This variable
has no effect when the value of cmnGlobalFeatureEnabled object
is false(2).
Setting this object to true(1) enables the sending of
cmnMacChangedNotification when a MAC address which this
interface learnt previously is removed from the forwarding
table.
Setting this object to false(2) disables the sending of
cmnMacChangedNotification when a MAC address which this
interface learnt previously is removed from the forwarding
table."DEFVAL{ false }::={ cmnIfConfigEntry 2}--*********************************************************************
-- Cisco Mac Notification Move Group
--*********************************************************************cmnMACMoveFeatureEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies whether the MAC Move notification feature is
currently running in the device.
Setting this object to false(2) disables the MAC Move
notification feature globally.
Setting this object to true(1) will start the MAC Move
notification feature running in the device."::={ cmnMACMoveObjects 1}cmnMACMoveNotificationsEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies whether cmnMacMoveNotification notifications
will or will not be sent when a MAC move is detected by
the MAC move notification feature.
Setting this object to false(2) will not send the
cmnMacMoveNotification notifications.
Setting this object to true(1) will send the
cmnMacMoveNotification notifications."::={ cmnMACMoveObjects 2}
cmnMACMoveAddress OBJECT-TYPESYNTAXMacAddressMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the MAC address that is moved between
cmnMACMoveFromPortId and cmnMACMoveToPortId on
cmnMACMoveVlanNumber. This object is instantiated only
when cmnMACMoveFeatureEnabled value is set to true(1) and
a MAC move is detected by the MAC move notification feature."::={ cmnMACMoveObjects 3}cmnMACMoveVlanNumber OBJECT-TYPESYNTAXVlanIndexMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the VLAN on which the cmnMACMoveAddress is
moved from cmnMACMoveFromPortId to cmnMACMoveToPortId.
This object is instantiated only when
cmnMACMoveFeatureEnabled value is set to true(1) and a
MAC move is detected by the MAC move notification feature."::={ cmnMACMoveObjects 4}cmnMACMoveFromPortId OBJECT-TYPESYNTAXInteger32(1..65535)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of dot1dBasePort for the bridge port from which
the cmnMACMoveAddress is moved to cmnMACMoveToPortId on
cmnMACMoveVlanNumber. This object is instantiated only when
cmnMACMoveFeatureEnabled value is set to true(1) and a
MAC move is detected by the MAC move notification feature."REFERENCE
"dot1dBasePort is defined in RFC1493."::={ cmnMACMoveObjects 5}cmnMACMoveToPortId OBJECT-TYPESYNTAXInteger32(1..65535)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of dot1dBasePort for the bridge port to which
the cmnMACMoveAddress is moved from cmnMACMoveFromPortId
on cmnMACMoveVlanNumber. This object is instantiated only
when cmnMACMoveFeatureEnabled value is set to true(1) and
a MAC move is detected by the MAC move notification feature."REFERENCE"dot1dBasePort is defined in RFC1493."::={ cmnMACMoveObjects 6}cmnMACMoveTime OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The value of sysUpTime when a cmnMACMoveAddress is moved
between cmnMACMoveFromPortId and cmnMACMACMoveToPortId.
This object is instantiated only when
cmnMACMoveFeatureEnabled value is set to true(1) and
a MAC move is detected by the MAC move notification feature."::={ cmnMACMoveObjects 7}--*********************************************************************
-- Cisco Mac Notification Threshold Group
--*********************************************************************cmnMACThresholdFeatureEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrent
DESCRIPTION"Specifies whether the MAC Threshold notification feature is
currently running in the device.
Setting this object to false(2) disables the MAC Threshold
notification feature globally.
Setting this object to true(1) will start the MAC Threshold
notification feature running in the device."::={ cmnMACThresholdObjects 1}cmnMACThresholdLimit OBJECT-TYPESYNTAX Percent
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Indicate the threshold limit of the forwarding table
utilization."::={ cmnMACThresholdObjects 2}cmnMACThresholdInterval OBJECT-TYPESYNTAXUnsigned32
UNITS"seconds"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Interval at which forwarding table utilization is compared
against cmnMACThresholdLimit."::={ cmnMACThresholdObjects 3}cmnMACThresholdNotifEnabled OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Specifies whether cmnMacThresholdExceedNotif
notifications will or will not be sent when the forwarding
table utilization exceeds or equals to cmnMACThresholdLimit
value. cmnMacThresholdExceedNotif notification is not sent
when cmnMACThresholdLimit is set to zero."::={ cmnMACThresholdObjects 4}
cmnUtilizationTable OBJECT-TYPESYNTAXSEQUENCEOF CmnUtilizationEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"cmnUtilizationTable specifies the forwarding table
utilization information. This table is instantiated only
when cmnMACThresholdFeatureEnabled value is set to true(1).
Entries in this table are updated at the end of every
cmnMACThresholdInterval."::={ cmnMACThresholdObjects 5}cmnUtilizationEntry OBJECT-TYPESYNTAX CmnUtilizationEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A conceptual row containing forwarding table utilization
maintained by switching engine (identified by
entPhysicalIndex). Each switching engine managed by this
MIB module can have at least one entry in this table."INDEX{ entPhysicalIndex }::={ cmnUtilizationTable 1}
CmnUtilizationEntry ::=SEQUENCE{
cmnUtilizationEntries
Unsigned32,
cmnUtilizationUtilization
Percent,
cmnUtilizationTimeStamp
TimeStamp}cmnUtilizationEntries OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the number of entries present in the forwarding
table for the given entPhysicalIndex calculated at the
end of cmnMACThresholdInterval."::={ cmnUtilizationEntry 1}cmnUtilizationUtilization OBJECT-TYPESYNTAX Percent
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the utilization of the forwarding table for the given
entPhysicalIndex calculated at the end of
cmnMACThresholdInterval."::={ cmnUtilizationEntry 2}cmnUtilizationTimeStamp OBJECT-TYPESYNTAXTimeStampMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Indicates the sysUptime at which the cmnUtilizationUtilization
is updated."::={ cmnUtilizationEntry 3}--
--
-- Notification
--cmnMIBNotificationPrefix OBJECTIDENTIFIER::={ ciscoMacNotificationMIB 2}cmnMIBNotifications
OBJECTIDENTIFIER::={ cmnMIBNotificationPrefix 0}cmnMacChangedNotification NOTIFICATION-TYPEOBJECTS{ cmnHistMacChangedMsg, cmnHistTimestamp }STATUScurrentDESCRIPTION"This notification is generated when there is enough MAC
address information to fully occupy a maximum size SNMP trap
message. This notification is also generated when there
is at least one MAC address changed or removed and the amount
of time elapsed from the previous notification is greater
than the maximum wait time denoted by
cmnNotificationInterval object.
If there are more MAC addresses information than can fit into
one cmmHistTrapContent object, then multiple notifications
will be generated."::={ cmnMIBNotifications 1}cmnMacMoveNotification NOTIFICATION-TYPEOBJECTS{
cmnMACMoveAddress,
cmnMACMoveVlanNumber,
cmnMACMoveFromPortId,
cmnMACMoveToPortId,
cmnMACMoveTime
}STATUScurrentDESCRIPTION"cmnMacMoveNotification is generated when a MAC address is
moved between two interfaces."::={ cmnMIBNotifications 2}cmnMacThresholdExceedNotif NOTIFICATION-TYPEOBJECTS{
cmnUtilizationUtilization,
cmnMACThresholdLimit,
cmnUtilizationTimeStamp
}STATUScurrentDESCRIPTION"cmnMacThresholdExceedNotif is sent when
cmnUtilizationUtilization exceeds or equals to the
cmnMACThresholdLimit for a given entPhysicalIndex.
cmnMacThresholdExceedNotif is not sent when
cmnMACThresholdLimit is set to zero"::={ cmnMIBNotifications 3}--
-- Conformance
--cmnMIBConformance OBJECTIDENTIFIER::={ ciscoMacNotificationMIB 3}cmnMIBCompliances OBJECTIDENTIFIER
::={ cmnMIBConformance 1}cmnMIBGroups OBJECTIDENTIFIER::={ cmnMIBConformance 2}-- CompliancecmnMIBCompliance MODULE-COMPLIANCESTATUSdeprecatedDESCRIPTION"The compliance statement for the CISCO-MAC-NOTIFICATION-MIB."MODULEMANDATORY-GROUPS{ cmnGlobalGroup,
cmnInterfaceGroup,
cmnNotificationGroup }::={ cmnMIBCompliances 1}cmnMIBComplianceVer1 MODULE-COMPLIANCESTATUScurrentDESCRIPTION
"The compliance statement for the CISCO-MAC-NOTIFICATION-MIB."MODULEMANDATORY-GROUPS{ cmnGlobalGroup,
cmnInterfaceGroup,
cmnNotificationGroup
}GROUP cmnMACMoveGroup
DESCRIPTION"This group is mandatory if the managed system
supports MAC Move notification feature."GROUP cmnMACThresholdGroup
DESCRIPTION"This group is mandatory if the managed system
supports MAC Threshold notification feature."GROUP cmnMACMoveNotifGroup
DESCRIPTION"This group is mandatory if the managed system
supports Notifications for MAC Move notification
feature."GROUP cmnMACThresholdNotifGroup
DESCRIPTION"This group is mandatory if the managed system
supports Notifications for MAC Threshold notification
feature."::={ cmnMIBCompliances 2}--
-- Units of Conformance
--
-- Units of Conformance
--cmnGlobalGroup OBJECT-GROUPOBJECTS{
cmnGlobalFeatureEnabled,
cmnNotificationInterval,
cmnMacAddressesLearnt,
cmnMacAddressesRemoved,
cmnNotificationsEnabled,
cmnHistTableMaxLength,
cmnHistMacChangedMsg,
cmnHistTimestamp,
cmnNotificationsSent
}STATUScurrentDESCRIPTION"A collection of objects providing the global configuration
and information for MAC notification."::={ cmnMIBGroups 1}
cmnInterfaceGroup OBJECT-GROUPOBJECTS{
cmnMacAddrLearntEnable,
cmnMacAddrRemovedEnable
}STATUScurrentDESCRIPTION"A collection of objects providing the configuration information
for MAC notification at each interface."::={ cmnMIBGroups 2}cmnNotificationGroup NOTIFICATION-GROUPNOTIFICATIONS{ cmnMacChangedNotification }STATUScurrentDESCRIPTION"The notification generated by the CISCO-MAC-NOTIFICATION-MIB."::={ cmnMIBGroups 3}cmnMACMoveGroup OBJECT-GROUP
OBJECTS{
cmnMACMoveFeatureEnabled,
cmnMACMoveNotificationsEnabled,
cmnMACMoveAddress,
cmnMACMoveVlanNumber,
cmnMACMoveFromPortId,
cmnMACMoveToPortId,
cmnMACMoveTime
}STATUScurrentDESCRIPTION"A collection of objects providing the global configuration
and information for MAC Move notification feature."::={ cmnMIBGroups 5}cmnMACThresholdGroup OBJECT-GROUPOBJECTS{
cmnMACThresholdFeatureEnabled,
cmnMACThresholdLimit,
cmnMACThresholdInterval,
cmnMACThresholdNotifEnabled,
cmnUtilizationEntries,
cmnUtilizationUtilization,
cmnUtilizationTimeStamp
}STATUScurrentDESCRIPTION"A collection of objects providing the global configuration
and information for MAC Threshold notification feature."::={ cmnMIBGroups 6}cmnMACMoveNotifGroup NOTIFICATION-GROUPNOTIFICATIONS{
cmnMacMoveNotification
}STATUScurrentDESCRIPTION"A collection of objects providing the notification
information for MAC Move notification feature."::={ cmnMIBGroups 7}cmnMACThresholdNotifGroup NOTIFICATION-GROUPNOTIFICATIONS{
cmnMacThresholdExceedNotif
}STATUScurrent
DESCRIPTION"A collection of objects providing the notification
information for MAC Threshold notification feature."::={ cmnMIBGroups 8}END